home *** CD-ROM | disk | FTP | other *** search
/ Pascal Super Library / Pascal Super Library (CW International)(1997).bin / LIBRARY / TP_TOOLS / LIST.DOC < prev    next >
Text File  |  1992-12-24  |  3KB  |  94 lines

  1. PROGRAMMING MANUAL
  2. ------------------
  3.   The following list of routines were written to provide disk I/O interface 
  4. support for programs written in Turbo Pascal (version 5.0).  The routines 
  5. include:
  6.  
  7. LIST_BUILD
  8. LIST_ERASE
  9. LIST_DIRECTORY
  10.  
  11. The following is a programming example for proper use of the list routines:
  12.  
  13. PROGRAM LIST_EXAMPLE
  14. USES DOS, CRT, GRAPH, LIST 
  15. BEGIN
  16.     LIST_BUILD('TEST.LST');
  17.     LIST_DIRECTORY(10,10,'*.LST',Output);
  18.     LIST_ERASE('TEST.LST');
  19. END;
  20.  
  21. NOTES: 1) The list unit must be included in the USES line (along with any 
  22. other required units).
  23.  
  24.  
  25. PROGRAMMING MANUAL
  26. ------------------
  27. LIST_BUILD
  28.  
  29. USE        LIST_BUILD(txt);
  30.  
  31. FUNCTION   Generates an empty file with the filename "txt".
  32.  
  33. ARGUMENTS  txt                  :STRING
  34.            Specifies the name of a file to produce.
  35.            Legal Values: Any 8 character string.
  36.  
  37. COMMENTS   Use this routine to produce a set of files that correspond to a set 
  38.            of program options. This is sometimes required when the options do 
  39.            not involve disk I/O, but when the programmer wants to use the the 
  40.            LIST routines for option selection.
  41.  
  42.  
  43. PROGRAMMING MANUAL
  44. -----------------
  45. LIST_ERASE   
  46.  
  47. USE        LIST_ERASE(txt);
  48.  
  49. FUNCTION   Erases the file with the filename "txt".
  50.  
  51. ARGUMENTS  txt                  :STRING
  52.            Specifies the name of a file to erase.
  53.            Legal Values: Any 8 character string.
  54.  
  55. COMMENTS   Use this routine to remove the "dummy" files created with the   
  56.            LIST_BUILD routine. This routine first checks to insure that the
  57.            specified file exists on the disk.
  58.  
  59.  
  60. PROGRAMMING MANUAL
  61. -----------------
  62. LIST_DIRECTORY   
  63.  
  64. USE        LIST_DIRECTORY(x, y, txtin, txtout);
  65.  
  66. FUNCTION   Provides a mouse driven interface disk I/O.                  
  67.  
  68. ARGUMENTS  x                    :INTEGER
  69.            Specifies the horizontal location of the interface window.
  70.            Legal Values: 1 to 55.
  71.  
  72.            y                    :INTEGER
  73.            Specifies the vertical location of the interface window.
  74.            Legal Values: 1 to 8.
  75.  
  76.            txtin                :STRING
  77.            Specifies the file type to load and scan.
  78.            Legal Values: Any 3 character string.
  79.  
  80.            txtout               :STRING
  81.            Returns the selected filename.
  82.  
  83. COMMENTS   This routine is not case sensitive and will return the upper case
  84.            equivalent of any filename selected or entered.
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.